home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / monitors / msfu / msfu.doc < prev    next >
Encoding:
Text File  |  1996-02-26  |  11.5 KB  |  227 lines
  1. REQUIREMENTS :
  2. ~~~~~~~~~~~~~~
  3.     Kickstart 2.04 or better.
  4.  
  5.  
  6. INTRODUCTION :
  7. ~~~~~~~~~~~~~~
  8.     MSFU stands for "Monitor System Files Usage". In other words,
  9. MSFU looks at the system files (currently devices and libraries)
  10. you _REALLY_ use (ie system files that are opened at least once
  11. by a program). This allows you to clean up "libs" directory or
  12. "devs" directory which are quickly filled by useless files when
  13. you install a lot of applications.
  14.     Note that to achieve this, MSFU _DOESN'T_ patch any library
  15. function (like OpenLibrary), but scans exec lists every xx minutes
  16. (where xx is chosen by the user). This method is less accurate
  17. than patching one, but safer for the system (I hate patches :^)).
  18.  
  19.  
  20. USING :
  21. ~~~~~~~
  22.     MSFU is an only CLI tool and should be called from "user-startup"
  23. file (of course it isn't an obligation, but it seems logical to do so).
  24. Its command line template is :
  25.  
  26. TF=TRACEFILE,LIBS/S,DEVS/S,ALL/S,FD=FIRSTDELAY/N,DELAY/N,BEEP/S,REQUESTER/S
  27.  
  28.     where :
  29.         - TRACEFILE is the name of the file where MSFU will save the
  30. results of its monitoring (by default : "PROGDIR:MSFU.trace")
  31.         - LIBS is a switch to indicate to MSFU to monitor libraries
  32.         - DEVS is a switch to indicate to MSFU to monitor devices
  33.         - ALL is a switch which replaces both LIBS and DEVS ones
  34.         - FIRSTDELAY is the amount of time (in minutes) before MSFU
  35. checks and saves the system files for the first time (by default :
  36. 10 minutes)
  37.         - DELAY is the amount of time (in minutes) between each time
  38. when MSFU checks and saves the system files (by default : 30 minutes)
  39.         - BEEP is a switch to tell MSFU to flash the screen (DisplayBeep
  40. function used) one second before checking and saving the system files
  41.         - REQUESTER is a switch to tell MSFU to request confirmation
  42. before checking and saving the system files
  43.  
  44.     If you call MSFU without none of LIBS, DEVS or ALL switches (whatever
  45. you give for other parameters), MFSU will simply show all the statistics,
  46. and will quit just after without monitoring anything. The statistics
  47. are printed in 6 columns both for libraries and devices : name, average
  48. open count, last time you used it, version number, number of different
  49. versions you have used since today, and last time you change of version.
  50. Output is sorted : the more opened files are shown before.
  51.     If you want to reset statistics, simply delete trace file.
  52.  
  53.     It may seem strange to have the two parameters FIRSTDELAY and DELAY.
  54. But FIRSTDELAY allows you to have a first scan just after booting. That's
  55. why I put 10 minutes by default : this leaves your Amiga the time to
  56. boot and you the time to run some applications. With DELAY, you can
  57. set the delay between the other scans, which is logically bigger (you
  58. don't change your activity every 10 minutes !).
  59.  
  60.     If you don't turn on one of the BEEP or REQUESTER switches, MSFU
  61. will save the scan results without noticing you, which can be dangerous
  62. (imagine you reboot your Amiga at this moment :^(). So I strongly advise
  63. you to use one of these switches. REQUESTER one is the safest (MFSU
  64. waits your agreement before saving), but BEEP one (MFSU flashes the
  65. screen one second before saving) may be enough for some people.
  66.  
  67.     MSFU will leave immediately if it recieves a CTRL-C signal.
  68.  
  69.     That's all folks !
  70.  
  71.  
  72. EXAMPLE :
  73. ~~~~~~~~~
  74.     You can find in my user-startup :
  75.  
  76. run >NIL: MSFU >NIL: ALL REQUESTER
  77.  
  78.     And now, when I simply type MSFU, I get :
  79.  
  80.             ›1;33;40mMSFU›0;31;40m v1.0
  81. Copyright © 1995, Lionel Vintenat
  82. ›1;32;40m---------------------------------›0;31;40m
  83.  
  84. 65 check were done since 20-Août-95.
  85.  
  86. ›1;33;40mLibrary name              Opened   Last used Version Chng Last change
  87. ›0;31;40mdos.library                77.82 05-Sep-95     39.23    0 20-Août-95 
  88. utility.library            49.82 05-Sep-95     39.10    0 20-Août-95 
  89. icon.library               20.83 05-Sep-95      39.3    0 20-Août-95 
  90. gadtools.library           20.77 05-Sep-95    39.356    0 20-Août-95 
  91. iffparse.library           13.82 05-Sep-95      39.2    0 20-Août-95 
  92. workbench.library           8.54 05-Sep-95     39.48    0 20-Août-95 
  93. rexxsyslib.library          4.40 05-Sep-95     36.23    0 20-Août-95 
  94. expansion.library           4.08 05-Sep-95      39.7    0 20-Août-95 
  95. whatis.library              2.58 05-Sep-95       4.2    0 20-Août-95 
  96. xpkmaster.library           2.15 05-Sep-95       2.4    0 20-Août-95 
  97. ilbm.datatype               2.03 05-Sep-95      39.9    0 20-Août-95 
  98. matrix.library              1.94 05-Sep-95   25.3004    0 20-Août-95 
  99. graphics.library            1.02 05-Sep-95     39.89    0 20-Août-95 
  100. layers.library              1.02 05-Sep-95     39.61    0 20-Août-95 
  101. keymap.library              1.02 05-Sep-95      37.2    0 20-Août-95 
  102. intuition.library           1.02 05-Sep-95   39.2084    0 20-Août-95 
  103. 8svx.datatype               1.02 05-Sep-95      39.4    0 20-Août-95 
  104. sound.datatype              1.02 05-Sep-95      39.5    0 20-Août-95 
  105. mathieeesingbas.library     1.02 05-Sep-95      37.3    0 20-Août-95 
  106. mathieeedoubbas.library     1.02 05-Sep-95      40.6    0 20-Août-95 
  107. exec.library                1.02 05-Sep-95     39.47    0 20-Août-95 
  108. français.language           1.02 05-Sep-95      38.1    0 20-Août-95 
  109. screennotify.library        1.00 05-Sep-95       1.0    0 20-Août-95 
  110. cronserver.library          0.97 05-Sep-95    30.134    0 20-Août-95 
  111. rexxhost.library            0.97 05-Sep-95      37.1    0 20-Août-95 
  112. parm.library                0.72 05-Sep-95      13.5    0 21-Août-95 
  113. archive.library             0.72 05-Sep-95       3.7    0 21-Août-95 
  114. muimaster.library           0.65 05-Sep-95      10.0    0 21-Août-95 
  115. mui-xenknob.image           0.28 05-Sep-95       7.9    0 21-Août-95 
  116. Floattext.mui               0.25 05-Sep-95     10.11    0 26-Août-95 
  117. Gauge.mui                   0.25 05-Sep-95     10.11    0 26-Août-95 
  118. req.library                 0.23 05-Sep-95       2.7    0 23-Août-95 
  119. mathffp.library             0.20 31-Août-95     39.1    0 21-Août-95 
  120. mathtrans.library           0.20 31-Août-95     40.6    0 21-Août-95 
  121. CrM.library                 0.17 05-Sep-95      4.30    0 20-Août-95 
  122. jpeg.datatype               0.06 28-Août-95     39.1    0 21-Août-95 
  123. powerpacker.library         0.06 29-Août-95    36.10    0 21-Août-95 
  124. scan1.library               0.05 27-Août-95    104.0    0 21-Août-95 
  125. xpkNUKE.library             0.02 05-Sep-95       1.0    0 21-Août-95 
  126. locale.library              0.00 05-Sep-95     38.27    0 20-Août-95 
  127. asl.library                 0.00 05-Sep-95      39.4    0 20-Août-95 
  128. datatypes.library           0.00 05-Sep-95     39.11    0 20-Août-95 
  129. diskfont.library            0.00 05-Sep-95      39.3    0 20-Août-95 
  130. reqtools.library            0.00 05-Sep-95   38.1266    0 20-Août-95 
  131. picture.datatype            0.00 05-Sep-95     39.14    0 20-Août-95 
  132. commodities.library         0.00 05-Sep-95      39.1    0 20-Août-95 
  133. toolmanager.library         0.00 05-Sep-95       3.1    0 20-Août-95 
  134. explode.library             0.00 05-Sep-95       6.0    0 21-Août-95 
  135. xpkSQSH.library             0.00 29-Août-95     1.10    0 21-Août-95 
  136. amigaguide.library          0.00 05-Sep-95     39.11    0 21-Août-95 
  137. amigaguide.datatype         0.00 05-Sep-95     39.15    0 21-Août-95 
  138. nonvolatile.library         0.00 22-Août-95    40.36    0 22-Août-95 
  139. lowlevel.library            0.00 22-Août-95    40.35    0 22-Août-95 
  140. mathieeedoubtrans.library   0.00 28-Août-95     40.6    0 28-Août-95 
  141. c.datatype                  0.00 28-Août-95    39.13    0 28-Août-95 
  142. text.datatype               0.00 29-Août-95     39.7    0 28-Août-95 
  143. ascii.datatype              0.00 29-Août-95     39.5    0 29-Août-95 
  144. xpkBLZW.library             0.00 29-Août-95      3.0    0 29-Août-95 
  145. xpkCBR0.library             0.00 29-Août-95      1.0    0 29-Août-95 
  146. xpkCRM2.library             0.00 29-Août-95      1.1    0 29-Août-95 
  147. xpkCRMS.library             0.00 29-Août-95      1.1    0 29-Août-95 
  148. xpkDHUF.library             0.00 29-Août-95     0.58    0 29-Août-95 
  149. xpkDLTA.library             0.00 29-Août-95      0.1    0 29-Août-95 
  150. xpkENCO.library             0.00 29-Août-95      1.0    0 29-Août-95 
  151. xpkFAST.library             0.00 29-Août-95      1.3    0 29-Août-95 
  152. xpkFEAL.library             0.00 29-Août-95      1.0    0 29-Août-95 
  153. xpkHFMN.library             0.00 29-Août-95     1.36    0 29-Août-95 
  154. xpkHUFF.library             0.00 29-Août-95     0.61    0 29-Août-95 
  155. xpkIDEA.library             0.00 29-Août-95      1.0    0 29-Août-95 
  156. xpkIMPL.library             0.00 29-Août-95      1.0    0 29-Août-95 
  157. xpkMASH.library             0.00 29-Août-95     1.98    0 29-Août-95 
  158. xpkNONE.library             0.00 29-Août-95      1.0    0 29-Août-95 
  159. xpkPWPK.library             0.00 29-Août-95      1.0    0 29-Août-95 
  160. xpkRAKE.library             0.00 29-Août-95      1.5    0 29-Août-95 
  161. xpkRDCN.library             0.00 29-Août-95      2.1    0 29-Août-95 
  162. xpkRLEN.library             0.00 29-Août-95      1.0    0 29-Août-95 
  163. xpkSHRI.library             0.00 29-Août-95      2.1    0 29-Août-95 
  164. xpkSMPL.library             0.00 29-Août-95      1.0    0 29-Août-95 
  165. ss.library                  0.00 31-Août-95    5.103    0 31-Août-95 
  166. binary.datatype             0.00 31-Août-95    39.10    0 31-Août-95 
  167. gif.datatype                0.00 02-Sep-95     39.16    0 02-Sep-95  
  168. f1gp.library                0.00 05-Sep-95      34.1    0 05-Sep-95  
  169.  
  170. ›1;33;40mDevice name      Opened   Last used   Version Chng Last change
  171. ›0;31;40mtimer.device      33.74 05-Sep-95        39.4    0 20-Août-95 
  172. input.device      13.97 05-Sep-95       37.12    0 20-Août-95 
  173. trackdisk.device   9.20 05-Sep-95        39.4    0 20-Août-95 
  174. console.device     4.02 05-Sep-95       39.28    0 20-Août-95 
  175. scsi.device        4.02 05-Sep-95   3940.3942    0 20-Août-95 
  176. mfm.device         3.06 05-Sep-95        38.5    0 20-Août-95 
  177. diskspare.device   3.05 05-Sep-95         3.0    0 20-Août-95 
  178. keyboard.device    2.06 05-Sep-95       37.12    0 20-Août-95 
  179. audio.device       1.15 05-Sep-95       37.10    0 20-Août-95 
  180. gameport.device    1.02 05-Sep-95       37.12    0 20-Août-95 
  181. ramdrive.device    1.02 05-Sep-95       39.35    0 20-Août-95 
  182. statram.device     1.02 05-Sep-95        37.7    0 20-Août-95 
  183. clipboard.device   0.97 05-Sep-95        38.8    0 20-Août-95 
  184.  
  185.  
  186. TECHNICAL :
  187. ~~~~~~~~~~~
  188.     Compiled with Amiga E v3.2a registered. Sources included.
  189.  
  190.  
  191. FUTURE :
  192. ~~~~~~~~
  193.     MSFU becoming a commodity ? Hummm, why not if some people request
  194. this feature :^)
  195.  
  196.  
  197. HISTORY :
  198. ~~~~~~~~~
  199.     1.0 : first release
  200.     1.1 : - correction of the aminet readme file : the "short" line
  201.            was taken from another readme file of mine :^)
  202.           - correction of the doc file : I forgot the last time to
  203.            mention that MSFU can be interrupted by CTRL-C (you know :
  204.            MSFU has so much features ;^) )
  205.           - I used timer device instead of Delay dos function, so now
  206.            MSFU leave _immediately_ if it recieves a CTRL-C signal
  207.           - MSFU waited for one second _before_ flashing the screen if
  208.            you switched on BEEP (hummm a bit stupid !), now it waits
  209.            for one second _after_ flashing the screen
  210.           - now MSFU gives you 3 choices instead of one ("Yes" !) when
  211.            opening the confirmation requester : "Yes", "No" and "Quit"
  212.  
  213.  
  214. DISTRIBUTION & DISCLAIMER :
  215. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  216. This software is subject to the "Standard Amiga FD-Software Copyright Note"
  217. It is FREEWARE as defined in paragraph 4a.
  218. For more information please read "AFD-COPYRIGHT" (Version 1 or higher).
  219.  
  220.     MSFU is freeware but however you can send me a postcard or an email
  221. if you use it :^)
  222.  
  223.  
  224. AUTHOR :
  225. ~~~~~~~~
  226.     Lionel Vintenat (vintenat@supaero.fr)
  227.